home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / wb / czesc_2 / iobject / doc / iobject.docfr < prev    next >
Text File  |  1993-03-31  |  24KB  |  948 lines
  1. TABLE OF CONTENTS
  2.  
  3.  
  4. IObject.lib/ActivateObject
  5. IObject.lib/AddObjectToWindow
  6. IObject.lib/AdjustBox
  7. IObject.lib/ClearTextArea
  8. IObject.lib/CreateObject
  9. IObject.lib/CreateTextArea
  10. IObject.lib/DisplayObject
  11. IObject.lib/Draw3DBox
  12. IObject.lib/EraseObject
  13. IObject.lib/ExitEasyGadget
  14. IObject.lib/FindObjectMsg
  15. IObject.lib/FreeObject
  16. IObject.lib/FreeTextArea
  17. IObject.lib/GetHotKey
  18. IObject.lib/GetObjectID
  19. IObject.lib/InitEasyGadget
  20. IObject.lib/ModifyObject
  21. IObject.lib/ObjectValue
  22. IObject.lib/OffObject
  23. IObject.lib/OnObject
  24. IObject.lib/RemoveObjectFromWindow
  25. IObject.lib/SendMsgToObject
  26. IObject.lib/SetTextAreaPen
  27. IObject.lib/SetIObjectColors
  28. IObject.lib/TAPrint
  29. IObject.lib/TAPrintf
  30. IObject.lib/TAPuts
  31.  
  32.  
  33. IObject.lib/ActivateObject                         IObject.lib/ActivateObject
  34.  
  35.   NOM  ActivateObject() -- Simule l'activation d'un IObject
  36.  
  37.     ActivateObject(object);
  38.  
  39.     VOID ActivateObject(CPTR);
  40.  
  41.   DESCRIPTION
  42.     Simule l'activation d'un IObject par un utilisateur, permet de gérer les
  43.     raccourcis-clavier. Tous les IObject ne sont pas affectés par cette
  44.     fonction (Par ex. l'activation d'un Scroller n'a aucun sens).
  45.  
  46.   ENTREES
  47.     object  - pointeur sur l'IObject.
  48.  
  49.   RESULTAT
  50.     aucun
  51.  
  52.   BOGUES
  53.     pas de bugs connus
  54.  
  55.  
  56. IObject.lib/AddObjectToWindow                   IObject.lib/AddObjectToWindow
  57.  
  58.   NOM  AddObjectToWindow() -- Ajoute un IObject à une fenêtre
  59.  
  60.     AddObjectToWindow(object, window, requester);
  61.  
  62.     VOID AddObjectToWindow(CPTR, struct Window *, struct Requester *);
  63.  
  64.   DESCRIPTION
  65.     Attache un IObject à une fenêtre, l'IObject n'est pas affiché sur la
  66.     fenêtre (Il faut utiliser DisplayObject pour l'afficher). Pour pouvoir
  67.     gérer les IObject il faut que la fenetre possede les IDCMP flags corres-
  68.     pondant aux IObjects ajoutés (IDCMP_xxxx).
  69.  
  70.   ENTREES
  71.     object    - pointeur sur le IObject.
  72.     window    - pointeur sur la fenêtre qui recoit l'IObject.
  73.     requester - pointeur sur le requester qui recoit l'IObject.
  74.  
  75.   RESULTAT
  76.     aucun
  77.  
  78.   BOGUES
  79.     Pour l'instant, on ne peut pas ajouter un IObject à un requester. Mettre
  80.     NULL pour le requester.
  81.  
  82.   VOIR AUSSI
  83.     RemoveObjectFromWindow()
  84.  
  85.  
  86. IObject.lib/AdjustBox                                   IObject.lib/AdjustBox
  87.  
  88.   NOM  AdjustBox() -- Calcule la boite à l'interieur d'une bordure
  89.  
  90.     AdjustBox(box, simple);
  91.  
  92.     VOID AdjustBox(struct Box *, BOOL);
  93.  
  94.   DESCRIPTION
  95.     Permet de calculer la taille et la position d'une boite à l'intérieur
  96.     d'une bordure (simple ou double) définie par box.
  97.  
  98.   ENTREES
  99.     box    - la boite qui sera ajustée. (box est modifiée)
  100.     simple - TRUE si c'est une bordure simple (BOX_1IN ou BOX_1OUT).
  101.  
  102.   RESULTAT
  103.     aucun
  104.  
  105.   BOGUES
  106.     pas de bugs connus
  107.  
  108.  
  109. IObject.lib/ClearTextArea                           IObject.lib/ClearTextArea
  110.  
  111.   NOM  ClearTextArea() -- efface le  TextArea
  112.  
  113.     ClearTextArea(textarea);
  114.  
  115.     VOID ClearTextArea(CPTR);
  116.  
  117.   DESCRIPTION
  118.     Efface le TextArea, et remet le curseur en haut du TextArea.
  119.  
  120.   ENTREES
  121.     textarea - pointeur sur le TextArea.
  122.  
  123.   RESULTAT
  124.     aucun
  125.  
  126.   
  127. IObject.lib/Createxxxx                                 IObject.lib/Createxxxx
  128.  
  129.   NOM  Createxxxx() -- Crée un IObject
  130.  
  131.     object = Createxxxx(new, id);
  132.  
  133.     CPTR Createxxxx(struct Newxxxx *, ULONG);
  134.  
  135.   DESCRIPTION
  136.  
  137.     Chaque classes d'IObjects possède une structure NewObject:
  138.  
  139.       struct NewObject
  140.       {
  141.         UWORD  LeftEdge, TopEdge;
  142.         UWORD  Width, Height;
  143.         UWORD  Flags;
  144.         UWORD  ClassFlags;
  145.         STRPTR LabelText;
  146.         struct TextAttr *Font;
  147.       };
  148.  
  149.     LeftEdge, TopEdge - Position de l'IObjet dans la fenêtre.
  150.     Width, Height     - Taille de l'IObject.
  151.     Flags             - Flags généraux pour tous les IObject, pour placer le
  152.                         label par rapport à l'IOject (LABEL_ABOVE au dessus,
  153.                         LABEL_BELOW en dessous, LABEL_RIGHT à droite,
  154.                         LABEL_LEFT à gauche, LABEL_INSIDE à l'interieur),
  155.                         LABEL_HOT_KEY permet de souligner le caractère
  156.                         précédé par '_' dans le label, LABEL_PEN2  utilise la
  157.                         couleur pen2 pour afficher le label (pen1 par défaut),
  158.                         OBJ_DISABLED pour rendre l'IObject unselectionnable.
  159.     ClassFlags        - flags spécifique à chaque classe (Voir plus loin).
  160.     LabelText         - Texte du label (peut être NULL).
  161.     Font              - Fonte utilisée par l'IObject. Un programme qui utilise
  162.                         IObject.lib doit déclarer la variable DiskfontBase,
  163.                         si vous n'ouvrez pas la diskfont.library, initialisez
  164.                         DiskfontBase à NULL, vous ne pourrez alors utiliser
  165.                         que les  fontes en ROM. Si la fonte ne peut pas être
  166.                         ouverte ou si Font est NULL, IObject.lib utilisera la
  167.                         fonte standard (Topaz 8).
  168.  
  169.   CLASS_CYCLE:
  170.  
  171.     CPTR CreateCycle(struct NewCycle *, ULONG);
  172.  
  173.     Crée un IObject qui permet de choisir une option parmi plusieurs.
  174.  
  175.       struct NewCycle
  176.       {
  177.         struct NewObject NewObj;
  178.         STRPTR *TextArray;
  179.       };
  180.  
  181.     ClassFlags - Aucun flags pour les Cycle
  182.     TextArea   - tableau de chaine pour les differentes options du cycle,
  183.                  doit se terminer par NULL.
  184.  
  185.   CLASS_BUTTON:
  186.  
  187.     CPTR CreateButton(struct NewButton *, ULONG);
  188.  
  189.     Crée un bouton, il peut servir d'interrupteur en utilisant BT_TOGGLE.
  190.  
  191.       struct NewButton
  192.       {
  193.         struct NewObject NewObj;
  194.       };
  195.  
  196.     ClassFlags - BT_TOGGLE transforme le bouton en interrupteur, il peut être
  197.                  selectionné ou non selectionné. BT_SELECTED selectionne
  198.                  l'interrupteur.
  199.  
  200.   CLASS_SCROLLER
  201.     
  202.     CPTR CreateScroller(struct NewScroller *, ULONG);
  203.  
  204.     Crée un IObject proportionnel, comme ceux utilisés dans les éditeurs de
  205.     textes pour ce déplacer dans le texte: indique le nombre de lignes
  206.     visible par rapport au nombre totale de ligne et la position dans le
  207.     texte.
  208.  
  209.       struct NewScroller
  210.       {
  211.         struct NewObject NewObj;
  212.         UWORD Pos;
  213.         UWORD CurSize;
  214.         UWORD MaxSize;
  215.       };
  216.  
  217.     ClassFlags - SC_VERTICAL permet d'avoir un scroller vertical, en utilisant
  218.                  SC_NOMOUSE le scroller ne prend pas en compte les évenements
  219.                  de la souris pour calculer sa position.
  220.     Pos        - Position du knob dans le scroller: de zéro à MaxSize.
  221.     CurSize    - Correspond à la partie visible.
  222.     MaxSize    - Correspond à la partie totale.
  223.  
  224.   CLASS_CHECK:
  225.  
  226.     CPTR CreateCheck(struct NewCheck *, ULONG);
  227.  
  228.     Crée un IObject qui peut servir d'interrupteur.
  229.  
  230.       struct NewCheck
  231.       {
  232.         struct NewObject NewObj;
  233.       };
  234.  
  235.     ClassFlags - CK_CHECKED si on veut que le check soit selectionné.
  236.  
  237.   CLASS_STRING:
  238.  
  239.     CPTR CreateString(struct NewString *, ULONG);
  240.  
  241.     Crée un IObject pour saisir une chaine de caratères.
  242.  
  243.       struct NewString
  244.       {
  245.         struct NewObject NewObj;
  246.         STRPTR Text;
  247.         UWORD  MaxLength;
  248.       };
  249.  
  250.     ClassFlags - STR_SINGLEBORD permet d'avoir une bordure simple au lieu
  251.                  d'une bordure double, STR_RIGHT et STR_CENTER permet de
  252.                  positionner le texte dans l'IObject: soit justifié à droite
  253.                  soit centré.
  254.     Text       - Texte dans le String au départ. (peut être NULL)
  255.     MaxLength  - Longueur maximale de la chaine à saisir. (MaxLength doit
  256.                  être inférieur à 280 pour l'instant).
  257.  
  258.   CLASS_INTEGER:
  259.  
  260.     CPTR CreateInteger(struct NewInteger *, ULONG);
  261.  
  262.     Crée un IObject pour saisir un entier long signé, on peut spécifier les
  263.     valeurs minimale et maximale que peut prendre cet entier avec la fonction
  264.     ModifyObject(). (Par défaut LONG_MIN et LONG_MAX.)
  265.  
  266.       struct NewInteger
  267.       {
  268.         struct NewObject NewObj;
  269.       };
  270.  
  271.     ClassFlags - voir ClassFlags pour le String.
  272.  
  273.   ENTREES
  274.     new - pointeur sur la structure Newxxxx correspondant à la classe de
  275.           l'IObject.
  276.     id  - numéro d'identification pour l'utilisateur.
  277.  
  278.   RESULTATS
  279.     object - pointeur sur l'IObject ou NULL si on ne peut pas le créer.
  280.  
  281.   BOGUES
  282.     pas de bugs connus
  283.  
  284.   SEE ASLO
  285.     FreeObject(), ModifyObject()
  286.  
  287.  
  288. IObject.lib/CreateTextArea                         IObject.lib/CreateTextArea
  289.  
  290.   NOM  CreateTextArea() -- Crée un TextArea
  291.  
  292.     textarea = CreateTextArea(newtextarea, rastport);
  293.  
  294.     CPTR CreateTextArea(struct NewTextArea *, struct RastPort *);
  295.  
  296.   DESCRIPTION
  297.     Crée un TextArea pour afficher du texte qui scrolle automatiquement quand
  298.     le texte a atteint le bas du TextArea. La structure NewTextArea est
  299.     composée de:
  300.  
  301.       struct NewTextArea
  302.       {
  303.         UWORD  LeftEdge, TopEdge;
  304.         UWORD  Width, Height;
  305.         UWORD  Flags;
  306.         UWORD  ClassFlags;
  307.         STRPTR LabelText;
  308.         struct TextAttr *Font;
  309.         UBYTE  FrontPen, BackPen;
  310.         UBYTE  InterLine;
  311.         UBYTE  WrMask;
  312.       };
  313.  
  314.     LeftEdge, TopEdge - définie la position du TextArea dans le rastport.
  315.     Width, Height     - définie la taille du TextArea dans le rastport.
  316.     Flags             - LABEL_ABOVE, LABEL_RIGHT, LABEK_LEFT, LABEL_BELOW,
  317.                         LABEL_PEN2 (cf CreateObject.)
  318.     ClassFlags        - Flags pour le TextArea:  TAF_SMOOTH_SCROLL pour avoir
  319.                         un scrolling plus fin (prend plus de temps), avec le
  320.                         flag TAF_CLIP_TEXT le texte qui est plus large que le
  321.                         TextArea est affiché à la ligne suivante, sinon le
  322.                         texte qui dépasse n'est pas affiché.
  323.     LabelText         - Label du TextArea.
  324.     Font              - Fonte qui sera utilisée pour le TextArea.
  325.     FrontPen          - Couleur du texte dans le TextArea.
  326.     BackPen           - Couleur du fond.
  327.     InterLine         - Espace entre deux ligne de texte, 1 permet d'aérer le
  328.                         texte. (0 est possible).
  329.     WrMask            - Masque pour les bitplanes du TextArea, les bits 1 à 8
  330.                         indiquent quels bitplanes seront utilisés pour écrire
  331.                         dans le TextArea. (1 bit à 1 veut dire que le bitplane
  332.                         correspond est utlisé). Par exemple pour un écran de
  333.                         profondeur 3, si vous voulez utiliser toutes les cou-
  334.                         leurs mettez 0x07, si vous ne voulez utiliser que les
  335.                         couleurs 1 à 4 mettez 0x03. Ce champs correspont au
  336.                         champs WrMask de la structure RastPort. Mettez -1 si
  337.                         ne vous savez  pas quoi mettre. (Moins il y a de
  338.                         bitplanes utilisés plus l'affichage sera rapide. si
  339.                         vous mettez 0, rien ne sera écrit.)
  340.  
  341.   ENTREES
  342.     newtextarea - pointeur sur une structure NewTextArea initialisé.
  343.     rastport    - pointeur sur un rastport.
  344.  
  345.   RESULTAT
  346.     textarea - pointeur sur un TextArea ou NULL si on ne peut pas le créer.
  347.  
  348.   VOIR AUSSI
  349.     FreeTextArea(), TAPrint(), TAPrintf(), TAPuts(), graphics/rastport.h
  350.  
  351.  
  352. IObject.lib/DisplayObject                           IObject.lib/DisplayObject
  353.  
  354.   NOM  DisplayObject() -- Affiche un IObject
  355.  
  356.     DisplayObject(object);
  357.  
  358.     VOID DisplayObject(CPTR);
  359.  
  360.   DESCRIPTION
  361.     Affiche un IObject dans une fenêtre, IL FAUT d'abord ajouter l'IObject à
  362.     une fenêtre avec AddObjectToWindow() avant d'utiliser DisplayObject().
  363.  
  364.   ENTREES
  365.     object - pointeur sur l'IObject.
  366.  
  367.   RESULTAT
  368.     aucun
  369.  
  370.   BOGUES
  371.     pas de bugs connus
  372.  
  373.   VOIR AUSSI
  374.     EraseObject()
  375.  
  376.  
  377. IObject.lib/Draw3DBox                                   IObject.lib/Draw3DBox
  378.  
  379.   NOM  Draw3DBox() -- Dessine une boite 3D
  380.  
  381.     Draw3DBox(boite, rastport, type);
  382.  
  383.     VOID Draw3DBox(struct Box *, struct RastPort *, ULONG);
  384.  
  385.   DESCRIPTION
  386.     Dessine la bordure définie par la boite dans un rastport. La bordure peut
  387.     être simple (BOX_1x) ou double (BOX_2x).
  388.  
  389.   ENTREES
  390.     boite    - pointeur sur une boite.
  391.     rastport - pointeur sur un rastport.
  392.     type     - type de la bordure (BOX_1IN, BOX_1OUT, BOX_2IN et BOX_2OUT).
  393.  
  394.   RESULTAT
  395.     aucun
  396.  
  397.   VOIR AUSSI
  398.     SetIObjectColors()
  399.  
  400.  
  401. IObject.lib/EraseObject                               IObject.lib/EraseObject
  402.  
  403.   NOM  EraseObject() -- Efface un IObject
  404.  
  405.     EraseObject(object);
  406.  
  407.     VOID EraseObject(CPTR);
  408.  
  409.   DESCRIPTION
  410.     Efface un IObject de la fenêtre; l'IObject n'est pas retiré de la fenêtre
  411.     il est seulement effacé.
  412.  
  413.   ENTREES
  414.     object - pointeur sur l'IObject.
  415.  
  416.   RESULTAT
  417.     aucun
  418.  
  419.   BOGUES
  420.     pas de bugs connus
  421.  
  422.   VOIR AUSSI
  423.     DisplayObject()
  424.  
  425.  
  426. IObject.lib/ExitEasyGadget                         IObject.lib/ExitEasyGadget
  427.  
  428.   NOM  ExitEasyGadget() -- Libere la mémoire utilisée par IObject.lib
  429.  
  430.     ExitEasyGadget();
  431.  
  432.     VOID ExitEasyGadget();
  433.  
  434.   DESCRIPTION
  435.     Avant de rendre la main au système vous DEVEZ appeler ExitEasyGadget().
  436.  
  437.   ENTREES
  438.     aucun
  439.  
  440.   RESULTAT
  441.     aucun
  442.  
  443.   BOGUES
  444.     pas de bugs connus
  445.  
  446.   VOIR AUSSI
  447.     InitEasyGadget()
  448.  
  449.  
  450. IObject.lib/FindObjectMsg                           IObject.lib/FindObjectMsg
  451.  
  452.   NOM  FindObjectMsg() -- Chercher l'IObject associé au message
  453.  
  454.     object = FindObjectMsg(message);
  455.  
  456.     CPTR FindObjectMsg(struct IntuiMessage *);
  457.  
  458.   DESCRIPTION
  459.     Cherche à quel IObject appartient l'IntuiMessage, renvoie le pointeur sur
  460.     un IObject si le message appartient à un IObject ou NULL sinon.
  461.  
  462.   ENTREES
  463.     message - pointeur sur une structure IntuiMessage.
  464.  
  465.   RESULTAT
  466.     object - pointeur sur l'IObject associé à l'IntuiMessage ou NULL.
  467.  
  468.   BOGUES
  469.     pas de bugs connus
  470.  
  471.  
  472. IObject.lib/FreeObject                                 IObject.lib/FreeObject
  473.  
  474.   NOM  FreeObject()  -- Libère un IObject
  475.  
  476.     FreeObject(object);
  477.  
  478.     VOID FreeObject(CPTR);
  479.  
  480.   DESCRIPTION
  481.     Libère la mémoire utilisée par l'IObject, vous devez retirer l'IObject
  482.     de la fenêtre avant de le libérer. (Vous n'êtes pas obliger de le retirer
  483.     de la fenêtre si vous fermez la fenêtre juste aprés la libération)
  484.  
  485.   ENTREES
  486.     object - pointeur sur l'IObject.
  487.  
  488.   RESULTAT
  489.     aucun
  490.  
  491.   BOGUES
  492.     pas de bugs connus
  493.  
  494.   VOIR AUSSI
  495.     Createxxx()
  496.  
  497.  
  498. IObject.lib/FreeTextArea                             IObject.lib/FreeTextArea
  499.  
  500.   NOM  FreeTextArea()  -- Libére un TextArea
  501.  
  502.     FreeTextArea(textarea);
  503.  
  504.     VOID FreeTextArea(CPTR);
  505.  
  506.   DESCRIPTION
  507.     Libere le TextArea crée par CreateTextArea().
  508.  
  509.   ENTREES
  510.     textarea - pointeur sur le textarea.
  511.  
  512.   RESULTAT
  513.     aucun
  514.  
  515.   BOGUES
  516.     pas de bugs connus
  517.  
  518.   VOIR AUSSI
  519.     CreateTextArea()
  520.  
  521.  
  522. IObject.lib/GetHotKey                                    IObject.lib/GetHotKey
  523.  
  524.   NOM  GetHotKey() -- Donne la HotKey d'un IObject
  525.  
  526.     car = GetHotKey(object);
  527.  
  528.     UBYTE GetHotKey(CPTR);
  529.  
  530.   DESCRIPTION
  531.     Renvoie le raccourcis-clavier utilisé par un IObject ou renvoie 0 s'il
  532.     n'a pas de raccourcis-clavier (Si l'IObject est unselectionnable on
  533.     renvoie 0 même si l'IObject a un raccourcis-clavier).
  534.  
  535.   ENTREES
  536.     object - pointeur sur l'IObject.
  537.  
  538.   RESULTAT
  539.     car - le raccourcis-clavier ou 0.
  540.  
  541.   BOGUES
  542.     pas de bugs connus
  543.  
  544.  
  545. IObject.lib/GetObjectID                               IObject.lib/GetObjectID
  546.  
  547.   NOM  GetObjectID() -- Renvoie l'ID de l'IObject
  548.  
  549.     id = GetObjectID(object);
  550.  
  551.     UWORD GetObjectID(CPTR);
  552.  
  553.   DESCRIPTION
  554.     Renvoie l'ID donné à l'IObject lors de sa création par Create.
  555.  
  556.   ENTREES
  557.     object - pointeur sur l'IObject.
  558.  
  559.   RESULTAT
  560.     id - le numéro affecté à l'IObject lors de sa création.
  561.  
  562.   BOGUES
  563.     pas de bugs connus
  564.  
  565.  
  566. IObject.lib/InitEasyGadget                         IObject.lib/InitEasyGadget
  567.  
  568.   NOM  InitEasyGadget() -- Initialise IObject.lib
  569.  
  570.     res = InitEasyGadget();
  571.  
  572.     BOOL InitEasyGadget();
  573.  
  574.   DESCRIPTION
  575.     Cette routine DOIT être appelée avant d'utiliser la IObject.lib, renvoie
  576.     TRUE si l'initialisation c'est passée sans problème, sinon renvoie FALSE
  577.     et la librarie n'est pas utilisable.
  578.  
  579.   ENTREES
  580.     aucun
  581.  
  582.   RESULTAT
  583.     res - renvoie TRUE si on peut utiliser la IObject.lib ou FALSE sinon.
  584.  
  585.   BOGUES
  586.     pas de bugs connus
  587.  
  588.   VOIR AUSSI
  589.     ExitEasyGadget()
  590.  
  591.  
  592. IObject.lib/ModifyObject                             IObject.lib/ModifyObject
  593.  
  594.   NOM  ModifyObject() -- modifie un IObject.
  595.  
  596.     ModifyObject(object, arg0, arg1, ...);
  597.  
  598.     VOID ModifyObject(CPTR, ...);
  599.  
  600.   DESCRIPTION
  601.     Modifie un IObject, le prototype de la fonction dépend de la classe de
  602.     l'IObject.
  603.  
  604.   ENTREES
  605.     object - pointeur sur l'IObject.
  606.  
  607.     CLASS_CYCLE
  608.       ModifyObject(object, textarray, numero);
  609.       VOID ModifyObject(CPTR, STRPTR *, ULONG);
  610.  
  611.       Change le TextArray du cycle, et l'option selectionné.
  612.  
  613.     textarray - nouveau tableau de texte a utiliser, ou NULL pour garder le
  614.                 même.
  615.     numero    - numero de l'option selectionnée.
  616.  
  617.     CLASS_SCROLLER
  618.       ModifyObject(object, position, visible, max);
  619.       VOID ModifyObject(CPTR, ULONG, ULONG, ULONG);
  620.  
  621.       Change la position du Knob, la taille courante et le taille maximale.
  622.  
  623.     position - position du Knob.
  624.     visible  - partie visible.
  625.     max      - maximun possible.
  626.  
  627.     CLASS_BUTTON
  628.       ModifyObject(object, select);
  629.       VOID ModifyObject(CPTR, BOOL);
  630.  
  631.       Sélectionne ou désélectionne un bouton (le bouton doit posséder le flag
  632.       BT_TOGGLE).
  633.  
  634.     select - TRUE si le bouton doit être selectionné.
  635.  
  636.     CLASS_INTEGER
  637.       ModifyObject(object, val, min, max);
  638.       VOID ModifyObject(CPTR, LONG, LONG, LONG);
  639.  
  640.       Définie la valeur de l'entier et la valeur maximale et minimale que peut
  641.       prendre l'entier.
  642.  
  643.     val - valeur de l'entier.
  644.     min - valeur minimale de l'entier.
  645.     max - valeur maximale de l'entier.
  646.  
  647.     CLASS_STRING
  648.       ModifyObject(object, texte);
  649.       VOID ModifyObject(CPTR, STRPTR);
  650.  
  651.       Change le texte de l'IObject.
  652.  
  653.     texte - texte pour le String.
  654.  
  655.     CLASS_CHECK
  656.       ModifyObject(object, select);
  657.       VOID ModifyObject(CPTR, BOOL);
  658.  
  659.       Coche ou non le Check.
  660.  
  661.     select - TRUE pour cocher la CheckBox.
  662.  
  663.   RESULTAT
  664.     aucun
  665.  
  666.   BOGUES
  667.     pas de bugs connus
  668.  
  669.  
  670. IObject.lib/ObjectValue                                IObject.lib/ObjectValue
  671.  
  672.   NOM  ObjectValue() -- Renvoie l'état d'IObject
  673.  
  674.     val = ObjectValue(object);
  675.  
  676.     CPTR ObjectValue(CPTR);  (le type de val dépend de la classe de l'IObject)
  677.  
  678.   DESCRIPTION
  679.     Renvoie la valeur de l'IObject.
  680.  
  681.   ENTREES
  682.     object - pointeur de l'IObject.
  683.  
  684.   RESULTAT
  685.     CLASS_CYCLE:
  686.       index = ObjectValue(object);
  687.       UWORD ObjectValue(CPTR);
  688.  
  689.       renvoie le numéro de l'option sélectionnée.
  690.  
  691.     CLASS_SCROLLER:
  692.       pos = ObjectValue(object);
  693.       UWORD ObjectValue(CPTR);
  694.  
  695.       renvoie la position du knob.
  696.  
  697.     CLASS_BUTTON:
  698.       select = ObjectValue(object);
  699.       BOOL ObjectValue(CPTR);
  700.  
  701.       spécifie si le bouton est sélectionné.
  702.  
  703.     CLASS_INTEGER:
  704.       val = ObjectValue(object);
  705.       LONG ObjectValue(CPTR);
  706.  
  707.       Renvoie la valeur de l'entier.
  708.  
  709.     CLASS_STRING:
  710.       texte = ObjectValue(object);
  711.       STRPTR ObjectValue(CPTR);
  712.  
  713.       Renvoie le pointeur sur texte.
  714.  
  715.     CLASS_CHECK:
  716.       select = ObjectValue(object);
  717.       BOOL ObjectValue(CPTR);
  718.  
  719.       Spécifie si l'IObject est coché.
  720.  
  721.   BOGUES
  722.     pas de bugs connus
  723.  
  724.  
  725. IObject.lib/OffObject                                    IObject.lib/OffObject
  726.  
  727.   NOM  OffObject()  -- Ghoste un IObject
  728.  
  729.     OffObject(object);
  730.  
  731.     VOID OffObject(CPTR);
  732.  
  733.   DESCRIPTION
  734.     Rend l'IObject unselectionnable (Ghost). Pour rendre l'IObject à nouveau
  735.     selectionnable il faut utiliser OnObject().
  736.  
  737.   ENTREES
  738.     object - pointeur sur l'IObject.
  739.  
  740.   RESULTAT
  741.     aucun
  742.  
  743.   BOGUES
  744.     pas de bugs connus
  745.  
  746.   VOIR AUSSI
  747.     OnObject()
  748.  
  749.  
  750. IObject.lib/OnObject                                     IObject.lib/OnObject
  751.  
  752.   NOM  OnObject() -- UnGhoste un IObject
  753.  
  754.     OnObject(object);
  755.  
  756.     VOID OnObject(CPTR);
  757.  
  758.   DESCRIPTION
  759.     Rend l'IObject selectionnable, c'est le contraire de OffObject().
  760.  
  761.   ENTREES
  762.     object - pointeur sur l'IObject.
  763.  
  764.   RESULTAT
  765.     aucun
  766.  
  767.   BOGUES
  768.     pas de bugs connus
  769.  
  770.   VOIR AUSSI
  771.     OffObject()
  772.  
  773.  
  774. IObject.lib/RemoveObjectFromWindow         IObject.lib/RemoveObjectFromWindow
  775.  
  776.   NOM  RemoveObjectFromWindow() -- Retire un IObject de sa fenêtre
  777.  
  778.     RemoveObjectFromWindow(object);
  779.  
  780.     VOID RemoveObjectFromWindow(CPTR);
  781.  
  782.   DESCRIPTION
  783.     Retire un IObject de la fenêtre associé. L'IObject n'est pas effacé de la
  784.     fenêtre, pour l'effacer il faut faire un EraseObject avant de le retirer.
  785.  
  786.   ENTREES
  787.     object - pointeur sur l'IObject.
  788.  
  789.   RESULTAT
  790.     aucun
  791.  
  792.   BOGUES
  793.     pas de bugs connus
  794.  
  795.   VOIR AUSSI
  796.     AddObjectToWindow(), EraseDisplay()
  797.  
  798.  
  799. IObject.lib/SendMsgToObject                        IObject.lib/SendMsgToObject
  800.  
  801.   NOM  SendMsgToObject() -- Envoie un IntuiMessage à un IObject
  802.  
  803.     modif = SendMsgToObject(object, message);
  804.  
  805.     BOOL SendMsgToObject(CPTR, struct IntuiMessage *);
  806.  
  807.   DESCRIPTION
  808.     Envoie un IntuiMessage à un IObject, l'IObject provient de la fonction
  809.     FindObjectMsg(), renvoie TRUE si l'IObject a été modifié. Il faut utiliser
  810.     ObjectValue() pour recupérer le nouvel état de l'IObject.
  811.  
  812.   ENTREES
  813.     object  - pointeur sur l'IObject.
  814.     message - pointeur sur une structure IntuiMessage.
  815.  
  816.   RESULTAT
  817.     modif - renvoie TRUE si l'IObject a été modifié ou FALSE sinon.
  818.  
  819.   BOGUES
  820.     pas de bugs connus
  821.  
  822.   VOIR AUSSI
  823.     FindObjectMsg(), ObjectValue()
  824.  
  825.  
  826. IObject.lib/SetTextAreaPen                         IObject.lib/SetTextAreaPen
  827.  
  828.   NAME  SetTextAreaPen() -- Change les couleurs du TextArea
  829.  
  830.     SetTextAreaPen(textarea, front, back);
  831.  
  832.     VOID SetTextAreaPen(CPTR, UBYTE, UBYTE);
  833.  
  834.   DESCRIPTION
  835.     Change les couleurs du TextArea. Si vous changez la couleur de fond vous
  836.     devez effacer l'ecran.
  837.  
  838.   ENTREES
  839.     textarea - pointeur sur le TextArea.
  840.     front    - couleur du texte.
  841.     back     - couleur du fond du TextArea.
  842.  
  843.   RESULTAT
  844.     none
  845.  
  846.  
  847. IObject.lib/SetIObjectColors                     IObject.lib/SetIObjectColors
  848.  
  849.   NOM  SetIObjectColors() -- Initialise les couleurs pour IObject.lib
  850.  
  851.     SetIObjectColors(back, light, dark, pen1, pen2);
  852.  
  853.     VOID SetIObjectColors(UBYTE, UBYTE, UBYTE, UBYTE, UBYTE);
  854.  
  855.   DESCRIPTION
  856.     Initialise les couleurs utilisées par IObject.lib pour dessiner les
  857.     bordures, pour effacer les IObjects et pour la couleurs des labels.
  858.  
  859.   ENTREES
  860.     back  - couleur utiliséd pour effacer les IObjects.
  861.     light - couleur pour le coté claire des bordures.
  862.     dark  - couleur pour coté sombre des bordures.
  863.     pen1  - couleur normale pour les labels.
  864.     pen2  - couleur des labels utilisant LABEL_PEN2.
  865.  
  866.   RESULTAT
  867.     aucun
  868.  
  869.   BOGUES
  870.     pas de bugs connus
  871.  
  872.  
  873. IObject.lib/TAPrint                                        IObject.lib/TAPrint
  874.  
  875.   NOM  TAPrint() -- Affiche un texte dans un TextArea
  876.  
  877.     TAPrint(textarea, texte);
  878.  
  879.     TAPrint(CPTR, STRPTR);
  880.  
  881.   DESCRIPTION
  882.     Ecrit un texte dans le textarea. le texte peut utiliser des retours
  883.     chariots (\n en C).
  884.  
  885.   ENTREES
  886.     textarea - pointeur sur le textarea.
  887.     texte    - le texte à afficher.
  888.  
  889.   RESULTAT
  890.     aucun
  891.  
  892.   BOGUES
  893.     les tabulations ne sont pas gérées.
  894.  
  895.   VOIR AUSSI
  896.     TAPrintf(), TAPuts()
  897.  
  898.  
  899. IObject.lib/TAPrintf
  900.  
  901.   NOM  TAPrintf() -- Affiche un texte formaté dans un TextArea
  902.  
  903.     TAPrintf(textarea, fmttexte, arg1, arg2, ...);
  904.  
  905.     VOID TAPrintf(CPTR, STRPTR, ...);
  906.  
  907.   DESCRIPTION
  908.     Affiche un texte avec des paramétres comme la fonction printf du C.
  909.  
  910.   ENTREES
  911.     textarea        - pointeur sur le TextArea.
  912.     fmttexte        - texte avec les styles de formattage de RawDoFmt().
  913.     arg1, arg2, ... - parametres pour le fmttexte.
  914.  
  915.   RESULTAT
  916.     aucun
  917.  
  918.   BOGUES
  919.     pas de bugs connus
  920.  
  921.   VOIR AUSSI
  922.     RawDoFmt(), TAPuts(), TAPrint()
  923.  
  924.  
  925. IObject.lib/TAPuts                                         IObject.lib/TAPuts
  926.  
  927.   NOM  TAPuts() -- Affiche un texte avec retour chariot dans un TextArea
  928.  
  929.     TAPuts(textarea, texte);
  930.  
  931.     VOID TAPuts(CPTR,char *);
  932.  
  933.   DESCRIPTION
  934.     même fonction que TAPrint à part que l'on fait un retour chariot.
  935.  
  936.   ENTREES
  937.     textarea - pointeur sur le textarea.
  938.     texte    - le texte à afficher.
  939.  
  940.   RESULTAT
  941.     aucun
  942.  
  943.   BOGUES
  944.     les tabulations ne sont pas gérées.
  945.  
  946.   VOIR AUSSI
  947.     TAPrintf(), TAPrint()
  948.